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ABSTRACT 

Web  Map  Services  may  provide  some  assistance  in  alleviating  the  high  cost  of  providing 
Geospatial  Information  System  (GIS)  capabilities  to  Defence  users.  This  report  discusses  the 
development  of  several  implementations  of  client  applications  of  the  Web  Map  Service 
interface.  Problems  encountered  in  the  use  of  various  Web  technologies  to  construct  the  client 
applications  are  detailed.  Suggestions  are  also  made  for  future  development  efforts  to 
improve  client  functionality. 
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Investigating  Web  Map  Service  Client 
Technologies 


Executive  Summary 

The  cost  of  providing  all  Joint  Command  Support  Environment  (JCSE)  users  with  a 
Geospatial  Information  System  (GIS)  capability  and  access  to  supporting  data  sets  is 
prohibitively  high.  Web-based  mapping  services  provide  a  cost  saving  by  isolating  GIS 
processing  capabilities  on  a  server  and  presenting  the  completed  map  product  to  a  user 
as  an  image.  Web  mapping  systems  typically  consist  of  one  or  more  servers  that 
provide  map  images  to  a  range  of  client  applications. 

The  investigation  of  different  Web  technologies  in  the  development  of  Web  Map 
Service  (WMS)  clients  was  undertaken  under  the  auspices  of  the  DSTO  Edinburgh 
Vacation  Student  program. 

Web  technologies  have  evolved  greatly  from  static  HMTL-encoded  pages,  and  each  of 
these  technologies  offers  different  capabilities  to  develop  client  applications.  In  almost 
all  cases  the  bulk  of  the  computation  of  the  client-server  interaction  is  conducted  in  a 
user  agent  such  as  a  Web  browser.  Determining  the  most  suitable  technology  to  be 
applied  to  the  development  of  a  client  application  requires  studying  the  benefits  that 
each  approach  presents. 

In  this  effort,  client  applications  were  developed  using  a  range  of  technologies.  No 
formal  experimentation  was  conducted  to  gather  data  regarding  the  merit  of  one 
technology  over  another.  Instead  the  student  conducting  this  implementation  study 
made  an  assessment  of  the  ease  of  applying  each  technology  to  the  problem  of 
developing  a  WMS  client. 

An  assessment  of  the  viability  of  applying  the  different  technology  to  this  problem 
domain  is  made  in  the  conclusion. 

Sample  source  code  from  two  client  applications  is  included  as  appendices.  No  formal 
design  information  is  recorded. 
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1.  Introduction 


The  concept  of  a  Web  Map  Service  (WMS)  [1]  has  been  developing  for  several  years  now, 
and  today  one  effort  is  controlled  and  guided  by  the  Open  GIS  Consortium  (OGC).  The 
OGC  comprises  of  more  than  230  companies,  government  agencies1  and  universities  that 
are  involved  in  a  consensus  process  to  develop  publicly  available  interoperable 
geoprocessing  specifications.  Open  interfaces  and  protocols  defined  by  Open  GIS 
Specifications  offer  solutions  that  "geo-enable"  the  Web,  that  is  enable  geographic  maps 
to  be  displayed  in  a  web  browser,  based  upon  criteria  specified  by  a  user. 

The  aim  of  this  report  is  to  discuss  the  available  technologies  and  the  methods  for 
building  web  based  mapping  clients.  A  focus  is  placed  on  classifying  the  clients  into 
groups,  based  upon  the  difficulty  of  development  related  to  their  technology,  the 
problems  encountered  during  development  and  how  easy  is  it  to  implement  varying 
degrees  of  functionality.  It  also  provides  a  guideline  to  help  developers  to  determine  the 
most  suitable  technology  to  build  web  mapping  clients. 


2.  Background  to  Web  Map  Services 

A  simple  WMS  consists  of  a  client  (typically  a  web  browser  interface)  that  sends  requests 
to  a  server  in  the  form  of  a  Uniform  Resource  Locator  (URL)  [2],  The  OGC  WMS 
specification  standardises  the  way  in  which  clients  request  maps  and  the  way  that  servers 
describe  their  data  structure.  Currently  there  are  three  operations,  the  first  two  of  which 
are  mandatory  for  any  WMS  implementation. 

1.  GetCapabilities  -  Obtain  service-level  metadata  in  the  form  of  an  extensible  mark-up 
language  (XML)  [3]  document  that  describes  the  content  of  WMS  servers  and 
acceptable  request  parameters. 

2.  GetMap  -  Obtain  a  map  image  whose  geospatial  and  other  parameters  are  well 
defined  by  the  user. 

3.  GetFeaturelnfo  -  Ask  for  information  about  particular  features  shown  on  a  map. 

The  content  of  the  URL  submitted  to  the  server  depends  upon  the  current  activity  of  the 
client.  If  the  client  needs  to  know  the  content  of  the  server  then  a  GetCapabilities  request  is 
issued.  This  request  returns  a  XML  document  with  the  available  data.  An  example  of  a 
GetCapabilities  request  is  below. 


1  DSTO  has  access  to  the  OGC  through  the  technical  membership  held  by  DIGO  on  behalf  of 
Australian  Defence. 
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e.g.  http:/ /demo. cubewerx.com/demo/cubeserv/cubeserv.cgi?Request=GetCapabilities&Service=WMS 

If  the  user  required  a  map  to  be  generated  within  their  browser  then  a  GetMap  request  is 
submitted.  The  required  parameters  are  summarised  in  Table  1.  An  example  of  a  GetMap 
request  is  below. 

e.g.  http://demo.cubewerx.com/demo/cubeserv/cubeserv.cgi?Layers= 
BARRIERL_lM:Foundation&SRS=EPSG:4326&BBox=-180/-90/180,90&Width=600&Height=400& 

Forma  t=jpeg&Styles=&Transparent=true&Version=l.l.l&Request=GetMap 


Request  Parameter 

Description 

VE  RSION =version 

Request  Version 

REQUEST=GetMap 

Request  name 

LAYERS=layer_list 

Comma-separated  list  of  one  or  more  map  layers. 

STYLES=style_list 

Comma-separated  list  of  one  or  more  styles. 

SRS=namespace:identifier 

Spatial  Reference  System  (SRS). 

BBOX=minx,miny,maxx,maxy 

Bounding  box  corners  (lower  left,  upper  right)  in  SRS  units 

WIDTH=output_width 

■"iiiiinii'iiiiii  ii i iiiiii^iivniTH'iiffiiiiHiri»iini 

HEIGHT-output_height 

FORM  AT=output_forma  t 

Output  format  of  map. 

Table  1:  Required  Parameters  of  a  GetMap  Request 


If  the  GetMap  request  is  incorrectly  formulated  or  requests  a  service  that  is  unavailable, 
the  server  will  return  an  exception  in  the  form  of  an  image  or  as  an  XML  document.  An 
optional  GetMap  request  parameter  can  specify  client  preference  for  exception  reporting. 

The  version  number  is  an  important  factor  in  the  URL  request.  It  relates  to  the  version  of 
the  WMS  specification  to  which  the  client  expects  that  the  server  will  comply.  The 
specification  has  been  modified  and  updated  several  times,  so  it  is  essential  that  the 
correct  version  be  selected.  If  the  server  is  unable  to  support  the  requested  version  of  the 
interface  there  is  provision  for  negotiation  of  a  mutually  acceptable  version  between  the 
client  and  server. 

Given  the  two  interface  requests,  a  common  role  of  the  client  is  to  simplify  the  creation  of 
the  URL  requests  that  are  sent  to  the  server.  A  user  should  have  the  ability  to  easily  select 
the  parameters  that  are  required  and  send  the  URL  to  the  server  without  having  to 
assemble  it  manually. 

To  find  more  details  about  the  Web  Map  Service  implementation  specification  see 
http://www.opengis.org/techno/implementation.htm. 
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3.  Types  of  Clients 

This  section  explores  five  different  types  of  clients,  namely  simple  link,  HTML  form,  servlet, 
JavaServer  Pages  (JSPs),  and  applet.  The  types  of  client  are  characterised  by  the  technology 
used  to  build  them  and  the  functionality  they  present  to  the  user.  Each  implementation  is 
characterised  by  a  description  of  the  technology  and  methods  undertaken  to  implement  a 
WMS  client.  Additionally,  the  functionality  developed  for  the  client  and  problems 
encountered  in  the  implementation  are  reported. 

3.1  Simple  link 

A  link  version  of  a  WMS  client  can  range  from: 

•  a  user  typing  in  a  request  URL  into  the  address  bar  of  a  browser, 

•  multiple  links  to  services  on  a  web  page, 

•  thumbnails  of  images  within  a  HTML  page  issue  the  appropriate  request  when 
selected. 

3.1.1  Available  Functionality 

This  method  provides  minimal  functionality  as  the  user  may  find  it  difficult  or  even 
impossible  to  change  the  parameters  of  the  map.  Presentation  to  the  user  of  the  link  as  a 
simple  word  (e.g.  "map")  or  thumbnail  image  hiding  the  actual  URL  prevents  the  user 
from  (anything  but  manually)  configuring  the  URL.  Complex  URLs  in  the  location  bar  of 
a  web  browser  are  not  readily  understandable  and  hence  difficult  to  modify  and 
customise.  The  URL  for  each  map  is  fixed  on  the  web  page,  and  must  be  manually 
modified  to  customise  the  map  displayed. 

3.2  HTML  Form 

A  form  is  a  section  of  a  HTML  document  containing  not  only  normal  content  and  mark¬ 
up  but  also  special  elements  called  controls  (checkboxes,  radio  buttons,  menus,  etc.)  that 
have  labels.  Users  generally  "complete"  a  form  by  modifying  its  controls  (entering  text, 
selecting  menu  items,  etc.),  before  submitting  the  form  to  the  server  for  processing.  The 
content  of  the  controls  make  up  the  content  of  the  URL  that  is  sent  to  the  server. 

3.2.1  Methods  Undertaken 

A  simple  HTML  page  with  two  frames  has  been  developed.  One  frame  contains  a  form 
and  its  controls,  and  the  other  provides  browser  space  where  the  returned  map  is 
displayed  (commonly  known  as  a  target  frame). 

A  user  types /selects  different  values  for  the  controls  and  submits  the  form  to  the  server 
by  clicking  a  button  labelled  "Get  Map".  The  values  of  the  controls  make  up  the 
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parameters  of  the  GetMap  request  URL.  The  server  returns  a  map,  based  on  the  input 
parameters  in  the  opposite  frame. 

3.2.2  Available  Functionality 

There  is  minimal  functionality  because  the  user  has  to  know  what  the  available 
parameters  of  the  map  server  are,  before  filling  out  the  form.  If  one  of  the  parameters  is 
incorrect  the  server  will  either  return  an  exception  or  provide  an  image  that  the  user  was 
not  expecting. 

3.2.3  Problems  Encountered 

A  problem  that  was  encountered  with  HTML  forms  was  that  some  user  agents  (i.e.  web 
browsers)  silently  performed  URL  encoding  notation  and  certain  web  map  servers  were 
unable  to  deal  with  (or  elected  not  to  support)  the  notation. 

The  encoding  notation  replaces  reserved  characters  with  a  three-character  representation. 
This  is  a  percent  sign  and  two  hexadecimal  digits  whose  value  corresponds  to  the  position 
of  the  character  in  the  ASCII  character  set.  For  example  a  space  is  converted  to  %20  or  a 
comma  is  converted  to  %2C  etc.  The  encoding  is  described  in  detail  in  [2]. 

The  OGC  specification  states  that  a  comma  must  separate  each  layer  of  the  map  request 
and  each  bounding  box  value.  When  sending  a  request  from  a  form,  these  comma 
characters  are  replaced  with  their  encoding  by  the  user  agent.  In  the  event  of  the  server 
not  recognising  the  notation,  it  does  not  recognise  the  notation  as  a  list  element  delimiter. 
When  a  server  is  incapable  of  dealing  with  these  notations,  an  exception  is  returned  for  an 
otherwise  legitimate  request. 

It  was  found  that  many  of  the  web-mapping  servers  had  very  strict  conformance  to  the 
OGC  Implementation  Specification  and  did  not  allow  for  the  ability  to  deal  with  the 
encoding.  One  server  that  conformed  strictly  to  the  specification  was  CubeWerx.  When 
trying  to  access  a  CubeWerx  server  from  a  form,  an  exception  is  always  returned  from  the 
server  stating  that  the  bounding  box's  values  are  incorrect.  The  ESRI  WMS  connector  to 
the  ArcIMS  server  was  capable  of  supporting  requests  from  a  HTML  form.  The  ESRI 
server  correctly  parses  the  encoded  URL  and  forwards  the  request  on  to  the  ArcIMS 
server  for  processing. 

The  OGC  membership  is  aware  of  the  issue  with  the  WMS  Version  1.1.1  and  seeks  to 
resolve  it  by  revision  of  the  relevant  sections  of  the  specification. 

3.3  Servlet 

A  servlet  is  a  server-side  software  component,  written  in  Java,  that  dynamically  extends 
the  functionality  of  a  web  server.  Unlike  applets,  servlets  do  not  display  a  graphical 
interface  to  the  user.  A  servlet's  work  is  done  "behind  the  scenes"  on  the  server  and  only 
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the  results  of  the  servlet's  processing  are  returned  to  the  client  (usually  in  the  form  of 
HTML). 

The  motivation  to  use  a  servlet  is  to  provide  dynamic  web  pages.  In  this  case  the  available 
layers,  bounding  box  values  and  other  attributes  of  the  map  are  automatically  generated 
when  the  web  page  is  first  opened.  This  is  done  by  parsing  the  document  that  is  returned 
by  the  server  in  response  to  a  GetCapabilities  request,  as  discussed  in  Section  4.1. 

For  a  servlet  to  generate  HTML,  it  requires  a  Java  PrintWriter  within  the  Java  source  file, 
for  example: 

res . setContentType ( "text/HTML" ) ; 

PrintWriter  out  =  res . getWriter ( ) ; 
out .println ( "<HTML>" ) ; 
out .println ( "<BODY>" ) ; 

out .println (layerArray [1] ) ;  //  an  array  that  contains  the  layers 
out. println ("</BODY>") ; 
out .println ( "</HTML>" ) ; 

A  more  complete  listing  of  the  code  developed  is  included  in  Appendix  A.2. 

3.3.1  Methods  Undertaken 

Due  to  the  fact  that  a  servlet  is  difficult  to  modify  because  of  the  integration  of  Java  and 
HTML  code,  it  was  found  that  it  was  best  to  first  create  and  set-up  the  HTML  page  using 
a  web  site  design  program,  with  placeholders  inserted  into  controls  of  the  page  for  the 
WMS  parameters. 

After  completing  the  design  of  the  page  the  HTML  code  is  copied  into  the  servlet  source 
file.  Dynamic  content  generated  by  parsing  the  GetCapabilities  XML  document,  replaced 
the  placeholder  elements. 

3.3.2  Available  Functionality 

Servlets  are  capable  of  supporting  all  the  functionality  discussed  in  Section  4.  Modifying 
an  existing  servlet  leads  to  several  problems  as  discussed  below. 

3.3.3  Problems  Encountered 

Changing  the  look  and  feel  of  the  application,  or  adding  support  for  a  new  type  of  client, 
requires  the  servlet  code  to  be  updated,  recompiled  and  then  redeployed  on  the  server, 
which  is  an  intensive  process. 

Taking  advantage  of  web-page  development  tools  when  designing  the  application 
interface  is  difficult.  If  such  tools  are  used  to  develop  the  web  page  layout,  the  generated 
HTML  must  then  be  manually  embedded  into  the  servlet  code.  This  process  is  time 
consuming  and  error  prone. 
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3.4  JavaServer™  Pages  (JSP) 

JavaServer™  Pages  [4]  is  another  technology  designed  for  the  development  of  web  based 
applications  and  is  based  on  the  servlet  technology.  The  main  distinction  between  a  JSP 
and  a  servlet  is  that  a  JSP  is  an  HTML  page  with  Java  code  embedded  within  HTML  tags, 
instead  of  a  servlet  being  Java  code  that  generates  the  web  page.  On  initial  access  the  JSP 
is  converted  into  servlet  source  code  and  then  compiled. 

This  distinction  greatly  simplifies  the  modification  of  the  client,  as  a  web  page 
development  tool  can  be  used  to  create  the  web  page.  The  HTML  code  can  still  be 
manipulated  within  the  document,  and  that  need  not  impact  upon  the  Java  code 
embedded  within  it. 

3.4.1  Methods  Undertaken 

The  JSP  was  created  using  a  web  page  development  tool.  The  design  and  layout  of  the 
web  page  is  initially  created,  and  then  the  dynamic  content  (as  explained  in  Section  4.1)  is 
added  after  by  inserting  the  Java  code  that  creates  it. 

Two  methods  were  considered  for  the  generation  of  the  dynamic  content:  an  Enterprise 
JavaBean™  (EJB,  or  simply  Enterprise  Bean)  [5]  and  a  standard  Java  Class.  Both  parse  the 
GetCapabilities  XML  document  and  return  the  available  parameters  from  the  server  by 
calling  methods  on  them. 

Due  to  the  constraints  of  the  unavailability  of  an  EJB  container  and  limited  time  there  was 
no  attempt  to  implement  an  EJB  solution.  Nonetheless  there  are  theoretical  benefits  to 
such  an  approach  and  as  such  we  describe  it  in  detail  below. 

An  EJB  is  a  middle-tier  component  that  encapsulates  the  business  logic  of  an  application. 
The  business  logic  is  the  code  that  fulfils  the  purpose  of  the  application.  EJBs  are 
implemented  as  Java  classes  that  require  a  container  within  which  to  execute.  The 
container  intercepts  requests  made  to  and  from  the  Enterprise  Beans  and  automatically 
provides  features  such  as  transaction  management,  persistence  and  security.  Requests  are 
forwarded  onto  the  Enterprise  Beans  by  the  container  on  behalf  of  the  client  making  the 
request. 

For  several  reasons.  Enterprise  Beans  simplify  the  development  of  large,  distributed 
applications.  First,  because  the  EJB  container  provides  system-level  services  to  Enterprise 
Beans,  developers  can  concentrate  upon  solving  business  problems. 

Second,  because  the  beans  and  not  the  clients  contain  the  applications  business  logic,  the 
client  developer  can  focus  on  the  presentation  of  the  client.  The  client  developer  does  not 
have  to  code  the  routines  that  implement  business  rules.  As  a  result  the  clients  are  thinner. 
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3.4.2  Available  Functionality 

JSPs  are  capable  of  supporting  all  the  functionality  discussed  in  Section  4.  What  is  ideal 
about  using  a  JSP  is  that  further  functionality  can  be  added  without  major  code 
modifications  such  as  a  servlet.  The  HTML,  Java  and  JavaScript  code  can  be  modified  and 
tested  within  one  file. 

3.4.3  Problems  Encountered 

There  were  no  significant  problems  encountered  when  implementing  the  Java  class  for  the 
JSP  version  of  the  client.  The  problems  faced  in  developing  the  servlet  version  were 
overcome  because  all  the  code  could  be  modified  and  tested  within  one  file.  This  made  it 
very  easy  to  build,  deploy  and  maintain. 

3.5  Applet 

Applets  are  Java  programs  that  are  downloaded  by  web  browsers  and  executed  by  a  Java 
Plug-in  within  the  web  browser  window.  The  full  Java  API  is  available  to  the  programmer 
including  the  Graphical  User  Interface  (GUI)  Toolkits.  This  allows  more  complex  user 
interfaces  to  be  built  than  those  available  in  standard  HTML. 

Applets  differ  from  the  other  technologies  in  drat  all  of  the  processing  is  performed  on  the 
client.  While  this  can  reduce  server  load,  the  processing  requirements  of  the  client  are 
greatly  increased  when  compared  to  HTML  and  JavaScript.  On  a  slow  client  the  time 
taken  to  start  an  applet  can  be  unsatisfactory. 

3.5.1  Methods  Undertaken 

The  applet  was  developed  using  the  Model-View-Controller  [6]  design  pattern.  Firstly, 
some  classes  representing  the  capabilities  XML  document  were  developed.  These  classes, 
along  with  the  GetMap  URL  became  the  model  part  of  the  design  pattern.  The  controllers 
would  then  manipulate  the  GetMap  URL  based  on  user  input  and  the  contents  of  the 
capabilities  classes.  When  notified,  the  map  display  would  update  the  map  image  by 
making  a  request  to  the  WMS  server  using  the  modified  URL. 

3.5.2  Available  Functionality 

Applets  are  capable  of  supporting  all  the  functionality  discussed  below.  With  a  flexible 
design  it  is  relatively  easy  to  add  new  features. 

3.5.3  Problems  Encountered 

The  applet  security  model  prohibits  opening  network  connections  to  servers  from  which 
the  applet  did  not  originate.  This  poses  a  problem  for  a  WMS  client,  which  needs  to  be 
able  to  connect  to  a  number  of  different  servers  to  be  truly  useful.  To  solve  this  problem 
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the  applet  needs  to  be  cryptographically  signed  using  a  digital  certificate  obtained  from  a 
Certificate  Authority. 

Applets  depend  on  the  Java  Virtual  Machine  (JVM)  for  execution  and  this  needs  to  be 
installed  on  each  client  machine.  Additionally,  not  all  Java  features  are  available  on  all 
versions  of  the  Java  Plug-in.  If  an  applet  requires  features  not  provided  by  the  client  Plug¬ 
in  it  needs  to  either  provide  the  libraries  itself  or  prompt  the  user  to  install  the  required 
Plug-in  version. 

In  a  configuration  managed  environment  it  may  not  be  possible  for  the  user  to  install  an 
up-to-date  JVM,  so  often  the  additional  libraries  will  need  to  be  provided  for  download 
from  the  applet's  website.  In  some  cases  this  can  drastically  increase  the  amount  of  code 
that  needs  to  be  downloaded  and  the  time  it  takes  for  the  applet  to  start  on  the  client 
machine. 


4.  Functionality  of  Clients 

4.1  Dynamic  Content 

Dynamic  Content  of  a  web  page  is  defined  as  content  that  changes  every  time  it  is 
accessed.  In  the  case  of  a  web-mapping  client,  the  dynamic  content  would  be  the  data  the 
client  is  able  to  access  on  the  server  and  the  restrictions  that  are  placed  on  that  data.  e.g. 
available  layers,  minimum  bounding  box  etc. 

Dynamic  content  is  created  by  determining  the  data  available  on  the  server  and  its 
structure.  This  is  done  by  sending  a  GetCapabilities  request  to  the  server,  which  returns  a 
XML  document.  The  client  is  then  able  to  parse  the  XML  document  and  determine  the 
HTML  content  to  fabricate. 

There  are  two  types  of  XML  parsers  available,  SAX  (Simple  API  for  XML)  [7]  and  DOM 
(Document  Object  Model)  [8].  The  two  types  of  parser  provide  applications  with  access  to 
the  information  stored  in  XML  documents.  They  both  provide  an  API  to  access  a 
document's  structure  (its  markup  tags)  and  content  (the  marked  up  information). 

Each  parser  takes  a  very  different  approach  towards  accessing  information.  DOM  creates 
a  tree  of  nodes  (based  on  the  structure  and  information  in  the  XML  document)  and  can  be 
accessed  by  traversing  the  tree.  The  textual  information  in  the  XML  document  is 
converted  to  leaf  nodes.  SAX,  on  the  other  hand,  notifies  the  application  of  what  is  in  the 
document  utilising  a  stream  of  events  to  represent  document  elements.  Either  style  of 
parser  may  validate  the  XML  document  against  a  schema  represented  as  either  a 
Document  Type  Definition  (DTD)  [9]  or  XML  Schema  [10]. 
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Validation  of  the  XML  document  returned  from  a  WMS  compliant  server  is  unnecessary. 
It  is  reasonable  to  assume  that  any  such  server  will  respond  to  the  GetCapabilities  request 
with  a  valid  XML  document. 

When  parsing  a  XML  document  with  a  validating  parser  it  is  important  to  first  determine 
which  version  of  the  WMS  the  server  is  implementing.  The  version  determines  which 
schemata  the  XML  document  conforms  to  and  as  such  this  will  how  the  program  parses 
the  XML  document.  The  WMS  specification  defines  how  version  number  negotiation 
should  be  carried  out  between  a  client  and  a  server. 


4.2  Zooming  and  Panning 

Zooming  and  Panning  are  essential  functions  in  web  mapping,  as  it  allows  the  user  to 
tune  the  image  displayed  to  suit  their  purposes. 

In  a  HTML  form  version  it  requires  an  abundance  of  JavaScript.  JavaScript  is  lightweight 
client  side  programming  language  that  is  usually  embedded  directly  in  HTML  pages  to 
add  interactivity  and  power  to  web  documents. 

In  the  HTML  implementation  of  the  WMS  client  it  was  found  that  implementing  the  zoom 
box  using  JavaScript  was  a  difficult  task.  It  involved  using  multiple  nested  dividers 
(HTML  elements),  one  that  contained  the  map  and  the  other  was  blank,  but  had  a  style 
sheet  that  gave  it  a  border  that  represented  the  zoom  box.  The  sample  code  for  setting  the 
zoom  box,  which  is  described  further  below,  can  be  found  in  Appendix  A.l. 

When  a  user  clicks  a  mouse  over  the  map  display,  the  setBorder()  function  is  called  to  set 
the  zoom  box  divider  to  become  visible.  The  top  and  left  attributes  are  set  to  equal  to 
where  the  user  clicked.  As  the  mouse  is  moved  over  the  map  the  mouseMoveHandler() 
function  refreshes  the  dividers'  width  and  height.  A  second  mouse  click  sets  the  divider  to 
be  hidden  again,  and  the  position  and  the  dimensions  of  the  divider  are  utilised  as  the 
new  bounding  box  values. 

The  positions  of  the  mouse  clicks  are  initially  stored  as  the  position  of  the  mouse  over  the 
image  in  pixels,  based  upon  the  image  size.  These  are  converted  to  the  coordinate  system 
of  the  map,  by  calculating  proportions  from  the  original  bounding  box  coordinates. 


5.  Other  Problems  when  Building  Clients 

Other  problems  encountered  when  building  and  deploying  WMS  clients  are  summarised 
below.  These  problems  are  unrelated  to  how  a  client  is  specifically  built. 
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5.1  Document  Type  Definitions 

It  is  recommended  that  the  capabilities  document  DTDs  be  stored  on  the  local  intranet. 
These  DTDs  are  required  by  WMS  clients  to  validate  tire  result  of  the  GetCapabilities 
request.  If  a  client  attempts  to  access  a  WMS  service  hosted  locally  and  requires  access  to 
DTDs  hosted  outside  the  intranet  that  are  unavailable,  the  XML  cannot  be  validated  and 
the  client's  parser  would  normally  throw  an  exception. 

Even  in  the  event  of  a  WMS  client  using  a  non-validating  XML  parser,  it  is  necessary  for 
the  DTDs  to  be  available  to  the  parser,  as  they  are  loaded  as  a  parser  artefact.  This  has 
implications  for  the  use  of  commercial  WMS  clients  on  Defence  networks  that  do  not  have 
Internet  connectivity.  Using  such  clients  requires  that  the  DTDs  location  be  masked  or 
aliased  in  the  domain  naming  service2,  or  modification  to  the  client  code  to  circumvent 
hard  coding  of  the  DTDs'  location. 

5.2  JavaScript 

JavaScript  is  used  for  most  of  the  functionality  of  the  HTML  implemented  WMS  client. 
The  JavaScript  languages  interpreted  by  Internet  Explorer  ("Jscript")  and  Netscape 
("JavaScript")  differ,  so  a  programmer  has  to  take  this  into  account  and  determine  what 
browser  is  being  used  and  then  apply  the  appropriate  code.  JavaScript  has  very  poor 
debugging  facilities  and  documentation  so  it  is  very  hard  to  develop  with  no  related 
experience. 

Efforts  to  standardise  the  JavaScript  language  into  a  common  language  ECMAScript  [11] 
may  provide  some  hope  in  easing  the  development  process. 

5.3  Tomcat  Server 

Our  WMS  servlet  clients  were  tested  using  the  Tomcat  servlet  engine.  It  was  discovered 
that  the  proxy  settings  for  the  servlet  engine  overrode  the  automatic  proxy  settings  for 
web  browsers  in  the  development  environment.  Attempts  to  access  WMS  services  hosted 
on  internet  servers  outside  the  firewall  were  denied  by  settings  permitting  access  to 
intranet  hosted  services.  Each  time  a  service  was  required  outside  the  network,  the  proxy 
settings  of  the  server  had  to  be  changed  and  then  restarted.  A  means  of  configuring  a 
solution  into  Tomcat  to  connect  directly  when  accessing  servers  within  the  local  network 
has  not  been  discovered. 

5.4  Image  Size  to  Bounding  Box  Ratios 

The  image  size  ratio  (width/height)  to  bounding  box  ratio  (latitude/longitude)  can  create 
problems  if  not  approximately  the  same.  If  tire  ratios  vary  by  a  large  margin,  the  resulting 
image  could  be  stretched,  compressed  or  filled  out  with  a  background. 


2  Replicating  DNS  names  in  Intranet  environments  is  not  a  recommended  process. 
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When  a  server  returns  an  image  that  has  been  padded  out  with  excess  backgroimd  (strips 
of  non-data),  it  is  indicative  of  the  bounding  box  ratio  differing  from  the  image  size  ratio. 
When  this  occurs  the  bounding  box  values  calculated  for  zooming  in  or  out  become 
incorrect.  When  the  user  clicks  on  the  image  to  start  the  zoom  box,  the  position  of  the  click 
is  transformed  from  image  pixels  to  coordinates.  If  the  coordinates  of  the  image  comers 
do  not  correspond  to  the  bounding  box  values  the  zoom  function  will  be  incorrect. 

A  solution  is  to  determine  the  ratio  of  the  bounding  box  when  the  GetCapabilities 
document  is  initially  parsed.  The  map  images  width  and  height  within  the  HTML 
document  can  then  be  adjusted  to  suit  the  ratio  of  the  bounding  box. 


6.  Future  Work 


6.1  Multiple  Services 

At  the  time  of  writing  this  document  no  implementation  of  client-side  composition  of  the 
output  from  multiple  services  has  been  completed.  The  composition  of  output  from 
multiple  services  means  that  map  layers  can  be  provided  by  distinct  servers  offering 
divergent  data  sources.  The  value  of  combining  these  data  sources  lies  in  being  able  to 
access  data  sourced  from  organisations  specifically  dedicated  to  the  product  they  offer. 

E.g.  A  client  may  seek  to  overlay  current  weather  pattern  information  upon  a  reference  map  of 
an  Operational  Area. 

When  requesting  multiple  layers  from  different  services  it  is  necessary  to  parse  each 
server's  GetCapabilities  document  separately,  and  then  generate  the  dynamic  HTML  code. 
The  implementation  of  a  WMS  client  may  need  to  consider  mechanisms  for  layer 
management  that  allows  a  user  to  specify  the  order  in  which  layers  are  displayed. 

6.2  Scribble  Layer 

A  "scribble  layer"  would  be  a  great  asset  to  have.  The  user  would  be  able  to  add  their  own 
text,  diagrams  and  other  drawing  objects  similar  to  a  Windows  Paint  program  and  then 
save  the  image  in  the  desired  format.  Map  annotations  could  be  added  to  customise  the 
server  output  to  the  purpose  of  a  user. 

6.3  Styled  Layer  Descriptor  Enabled  Client 

Styled  Layer  Descriptors  (SLDs)  [12]  allow  a  client  to  tell  a  server  how  it  wants  a  layer  to 
be  rendered.  This  allows  a  user  to  customise  the  appearance  of  data,  and  to  classify  data 
based  on  their  interests  and  see  those  classifications  as  graphical  differences.  Given  the 
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alternative  is  for  the  customer  to  request  that  a  map  service  provider  modify  the  service 
itself,  the  advantage  of  the  SLD-enabled  WMS  approach  is  clear. 

SLDs  also  allow  greater  knowledge  of  the  map  on  the  client  side.  Instead  of  the  client 
requesting  a  map  and  receiving  an  image  defined  by  the  service  provider's  conventions,  it 
could  know  the  exact  details  of  the  symbology  and  appearance  of  the  map,  allowing  for 
greater  control  in  construction  of  legends,  user  tools  and  other  client  features. 

As  services  supporting  SLDs  become  more  numerous,  clients  that  exploit  this  capability 
will  need  to  be  considered  as  the  benchmark,  rather  than  the  exception. 


7.  Conclusion 

The  aim  of  this  report  was  to  discuss  the  available  technologies  and  the  methods  for 
building  web  based  mapping  clients.  The  WMS  specification  provides  a  rigorous  interface 
for  a  client  to  request  maps  from  a  service.  Such  rigour  is  beneficial  in  that  it  allows 
different  (vendor's)  client  implementations  to  interact  with  services  from  different 
providers.  Additionally  clients  can  expect  services  to  behave  in  a  well-known  manner, 
issues  such  as  described  in  3.2.3  notwithstanding. 

Supplemental  specifications  in  the  Open  GIS  Web  Services  architecture  space  extend  the 
limited  expressiveness  of  the  WMS  interface.  Exploitation  of  this  additional  capability 
extends  the  functionality  available  in  WMS  clients. 

The  technology  used  to  implement  WMS  clients  is  broadly  varied.  Development  of  a 
WMS  client,  due  to  the  complexity  of  some  user  interface  operations  (e.g.  expressing  pan 
and  zoom  actions  within  a  user  agent),  benefits  from  the  more  sophisticated  technologies 
applicable.  There  is  a  role  for  simple  technologies,  such  as  HTML-based  clients,  that 
provide  all  the  complexity  required  to  implement  "thumbnails"  or  overview  maps, 
without  the  computational  overhead  of  the  more  advanced  technologies. 
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/  /  Bounding  box  values 
var  xmin  =  -180; 
var  ymin  =  -90; 
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var  newBBox  =  (roundA2nount(upLeftCoordx)+"/"+roundAmoimt(upLeftCoordy  -  ydiff)+","+roundAmoamt(upLeftCoordx  + 
xdiff)+'V'+roundAmount(upLeftCoordy)); 
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function  loadlmgO  { 

document.all.maxControls.style.visibility=  "hidden"; 


DSTO-TN-0536 


bo 

o3 

bo 

« 

B 

T3 

«5 

o 

hJ 

OJ 

£ 

JjJ 

3 


o 

o 


OJ 

ns 


o 

o 


T3 

(Li 

c/s 


bo 


T 3 
ns 
O 


S  .2 


*  S2 


§ 

o 

6 

< 

§ 

o 

J-l 


3 

B 

o  _ 

(-1 

c 

o 

X!  05 
u  h 


£ 

r*H 

T3 

= 

+  CO 

o 

o 

+ 

O 

=  ’ 

o  -y 

Jh 

+ 

"bo  ,-H'' 

■£j 

M— i 

o 

X 

0) 

V) 

.a  + 

(T3 

6 

£ 

«  bo 

+ 

xi 

.a 

£ 

0> 

^  .a 

ui  ij 

H  II 


o 

v 


c n  (£ 


j-i 
rt  nS 
>  > 


II 

„  II 
'S  <N 

5  + 


*H  c/s 
> 


Mh 


CU 


19 


setBorder()  -  set  the  border  of  the  zoomln  box 


if  (firstClick)  { 

initMouseX=event.clientX; 
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setCoordinatesQ  -  used  to  determine  the  new  coordinates  of  the  BBox 
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/*  mouseMo v eHandler ()  -  used  to  set  the  height  and  width  of  the  zoomln  box  (divider)  when  the  mouse  is  moving.  It  also  makes  sure 

the  zoomln  box  is  within  the  the  image.  */ 


function  mouseMoveHandlerO  { 

if  (isMoving)  { 

//do  not  allow  x  values  to  be  negative 
if  (event.clientX  <  initMouseX)  { 
document.all.Layerl.style.width  =  1 
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else  { 

doctiment.all.Layerl.style.height  =  event.clientY  -  initMouseY; 
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import  java.net.*; 


public  class  dmsolutions  extends  HttpServlet  { 
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oiit.prmt]n("</select>"); 
out.println(  "<  /  TR>  "); 
out.println("</TBODY>  ") 
out.println("</TABLE>"); 
out.prmtln("</fonn>"); 
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out.prmtln(''strSel  +=  sel[item]  .value;") 
out.println("if  (i<sel.length-l)  {"); 
out.println("strSel  +=  Y'A";"); 
out.println(")"); 
out.println("i++;"); 
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out.println("</ select>"); 

otit.println("</TD>"); 

out.println("</TR>"); 


oiit.prmtln("<TR>”); 

out.println("<TD>BGCOLOR</TD>"); 

out.println("<TD>"); 

out.println("<select  name=\"BGColor\">”); 
out.printli\(''<option  value=\"Oxffffff\">White</ option>"); 
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String  BBox  =  "" 
String  Format  = 


Document  doc  =  parseXmlFile(false); 
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for  (int  i  =  1;  i  <  getExceptChildren.getLength();  i++)  { 
Node  theMapChild  =  getExceptChildren.item(i); 
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if  (children2.item(j).getNodeName().equals("Title"))  { 

NodeList  children3  =  children2.item(j).getChiIdNodes(); 
Node  Title  =  children3.item(0); 
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/  /  Parses  an  XML  file  and  returns  a  DOM  document. 

/  /  If  validating  is  true,  the  contents  is  validated  against  the  DTD 
/  /  specified  in  the  file. 
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catch  (IOException  e)  { 

System.out.println("This  file  does  not  exist"); 
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